The TeXTractor Dialog

Exporting text is easy with TeXTractor’s easy-to-use interface. To activate the TeXTractor dialog, choose Export All Text… from the Utilities menu. 

                                                        The TeXTractor dialog

The TeXTractor dialog includes several controls which are used to set how the text should be exported:

Export Text field — Allows the user to name the text file to be created containing the exported text.

Filter popup menu — Enables the user to select one of the filters currently available to QuarkXPress.

                                                        A sample Filter popup menu

All Boxes radio button — A radio button used to indicate  all text in the document should be exported.

Break Links check box — Use this check box to choose whether or not linked text chains should be broken when text is exported. (Disabled when the All Boxes radio button is not selected)

Style radio button — A radio button used to indicate that only text with a certain style sheet should be exported.

Style popup menu — A popup menu which lists the style sheets available to the current document. Use this menu to choose which style text should be exported when TeXTractor exports text by style. (Disabled when the Style radio button is not selected)

Imported Stories radio button — A radio button used to indicate that only text from imported stories should be exported.

Tagged Stories radio button — A radio button used to indicate that text of stories which were tagged with TeXTractor should be exported.

TeXTractor allows the user to extract text from a QuarkXPress document by one of four criteria:

1.
All text
2.
Text with a designated style sheet applied to it
3.
Imported stories
4.
Tagged stories

Exporting All Text in a Document

To export all text in a document, choose Export All Text… from the Utilities menu to activate the TeXTractor dialog. Enter a name for the text file which is to be created, then choose the desired filter from the Filter popup menu. Next select the All Boxes radio button.

 

                                                Exporting all text in a document

Use the Break Links check box to indicate linked boxes containing text chains should be handled when the text is exported. If the Break Links check box is checked, links between text boxes are broken and the text is exported box by box in left-to-right, top-to-bottom order. If the Break Links check box is unchecked, stories which span multiple linked text boxes are kept intact when their text is exported to a file. 

When the controls on the TeXTractor dialog are all set as desired, click the Save button. TeXTractor exports the text from all of the text boxes in the document and creates a text file using the file name chosen by the user. 

Exporting Text by Style Sheet

Sometimes it is necessary to export all of the text of a certain style. If a common style sheet is applied to all text which needs to be exported, TeXTractor can easily export only the text which contains that style sheet. To export all text which shares a specific style sheet, choose Export All Text… from the Utilities menu to activate the TeXTractor dialog. Enter a name for the text file which is to be created, then choose the desired filter from the Filter popup menu. Next select the Style radio button 

                                                  Exporting text by style sheet

Use the Style popup menu to choose which style sheet is applied to all of the text which should be exported. The Style popup menu only allows one style sheet to be chosen for export. When the controls on the TeXTractor dialog are set, click the Save button, and TeXTractor exports all of the text which has the specified style sheet applied to it.

Exporting Text which was Imported into QuarkXPress®

TeXTractor makes it possible to export all of the text which was originally imported into QuarkXPress using the Get Text… command. To do so, first choose Export All Text… from the Utilities menu to activate the TeXTractor dialog. Enter a name for the text file which is to be created, then choose the desired filter from the Filter popup menu. Next select the Imported Stories radio button.

 

                                   Exporting only imported stories from a document

When the controls on the TeXTractor dialog are set, click the Save button. TeXTractor exports the text from all stories which were imported into QuarkXPress while disregarding other text. The text is placed in a file which is given the name chosen by the user.

Exporting Tagged Stories

TeXTractor makes it possible for the user to export particular text stories while disregarding any other text in the document. To do this, the XTension allows the user to indicate which stories should be exported through the Story Listing dialog. To activate the Story Listing dialog, choose Story Tags List… from the Utilities menu. 

                                                     The Story Listing dialog

The Story Listing dialog contains a list of every story found in the current QuarkXPress document. Each story is identified by the text found at the beginning of the story. 

Clicking on one of the listed stories does two things. The story is displayed at the upper left corner of the monitor, and the Save setting is toggled. Clicking once on a story makes a check mark appear in the Save column and clicking a second time makes the check mark appear. Stories with a check mark in the Save column of the Story Listing dialog are tagged as being intended for extraction when TeXTractor exports tagged stories. 

There are three buttons at the bottom of the Story Listing Dialog. All Off removes all checks from the Save column while All On puts puts check marks in every story’s row. These buttons are very convenient when the settings of many text stories need to be changed. Once all stories are tagged which need to be exported, click the Done button to close the dialog.

To export the stories which were tagged with the Story Listing dialog, choose Export All Text… from the Utilities menu to activate the TeXTractor dialog. Enter a name for the text file which is to be created, then choose the desired filter from the Filter popup menu. Next select the Tagged Stories radio button.

                                     Exporting tagged stories from a document

When the controls on the TeXTractor dialog are set, click the Save button. TeXTractor exports the text from all stories which were tagged while other text in the document is ignored. A text file is created to hold the exported text using the name indicated by the user.

Notes

•
Exporting text using a filter instead of exporting to ASCII takes longer to process.
•
Quark’s XPress Tags Filter must be present in the QuarkXPress folder for TeXTractor to export using any non-ASCII filter.